Description

Fixes #1399. Adresses #1211.

⚠️ Should be merged after the TiGL 3.5 release. This is unstable and needs further testing.

Today TIGLCreatorContext (the shared OpenCASCADE 3D scene) has a single global InteractiveShapeManager and a single global deleteAllObjects(). That's fine as long as only one CPACS document is ever open, but it's the reason multiple simultaneously-open documents (#1211) can't work: two open documents could easily share a component UID (e.g. two sibling models from one CPACS file, or two variants of the same aircraft), which would silently collide in the shared shape manager, and closing/redrawing one document would wipe every document's shapes out of the viewport.

This PR introduces a DocumentId (TIGLCreator/src/DocumentId.h) and scopes the scene's shape bookkeeping
to it:

• GetShapeManager() → GetShapeManager(DocumentId), backed by a std::map<DocumentId, InteractiveShapeManager> instead of one shared instance.
• Every displayShape/displayPoint/displayVector/displayShapeHLMode/displayLineHLMode call now takes a DocumentId and registers the resulting AIS object against it, so unnamed/untracked shapes (e.g. control-point-net previews) are also scoped correctly, not just named ones.
• New deleteObjectsOfDocument(DocumentId) removes only one document's shapes from the scene, leaving other open documents' shapes untouched — the scoped replacement for the old global deleteAllObjects().
• New GetShapeFromIObject(...) at the context level resolves a 3D-view pick across all open documents' shape managers, since a click in the shared viewport can land on any of them.

I made the DocumentId parameter mandatory everywhere rather than defaulted, specifically so the compiler would force auditing every call site (there turned out to be ~150 of them across TIGLCreatorDocument.cpp, ModificatorModel.cpp, TIGLCreatorWidget.cpp, ModificatorDisplayOptionsWidget.cpp, TIGLCreatorWindow.cpp, and TIGLCreatorInputoutput.cpp`) rather than risk silently missing one.

This PR is intentionally a pure backend refactor with no user-visible behavior change. Only one document is ever open today, so a single fixed DocumentId is used everywhere and every code path behaves exactly as before. It lays the groundwork for #1400 (tabbed CPACS tree for multiple open documents) and #1302 (auto-loading multiple models from one file), neither of which is possible without this.

One subtlety worth calling out for review: deleteObjectsOfDocument() intentionally does not clear a document's named shape-manager entries (unlike closing a document, which does, via a separate GetShapeManager(id).clear() call) — several redraw code paths rely on HasShapeEntry() still returning true for shapes that were removed from the viewport but not yet redrawn. Folding the clear into the delete would have subtly changed "draw only if not already displayed" behavior at ~14 call sites.

How Has This Been Tested?

Not at all 😨

Screenshots, that help to understand the changes(if applicable):

Checklist for PR Author:

• Unit or integration test added (if applicable)
• Python interface updated (if applicable)
• Python test added (if Python interface updated)
• Doxygen docstrings added
• ChangeLog.md updated